Silicon Graphics, Inc.

Java3D^TM Release Notes

In addition to the information here, also see Sun's Java3D^TM Website for more general information about the purpose and use of the Java3D^TM API.

General Release Notes

This is the final release of an implementation of version 1.3.1 of the Java3D^TM API, which is a set of classes and shared libraries that allows the use of Silicon Graphics Java Environment to develop and execute Java programs written in the Java3D^TM API. This software requires IRIX 6.5 or later, and Java^TM2 APIs v1.4.1 or later for Irix.

Java3D^TM on IRIX

Java3d expects to be installed on top of an SGI Java2 APIs v1.4.1 or later installation. Once you install java3d you can run some of the demos that are under /usr/demos/java/j3d. You will need to set the environment variable JAVA_OPENGL_NATIVE . For example to run HelloUniverse you do the following

setenv JAVA_OPENGL_NATIVE
cd /usr/demos/java/j3d/programs/examples/HelloUniverse/
/usr/java2/bin/java HelloUniverse

If you install java3d elsewhere, then to run Java3D^TM programs you will need to set your CLASSPATH and LD_LIBRARYN32_PATH to point to the java3d core libraries.

For example, if you install java3d under /j3d/usr/java2, the following C-shell alias can be used to setup your CLASSPATH and LD_LIBRARYN32_PATH correctly to run java3d applications.

alias j3d-setup-install

  'setenv J3D /j3d/usr/java2 ;

   setenv JAVA_OPENGL_NATIVE ;
   setenv CLASSPATH ".:$J3D/lib/ext/vecmath.jar:$J3D/lib/ext/j3dcore.jar:$J3D/lib/ext/j3dutils.jar:$J3D/lib/ext/j3daudio.jar" ;

   setenv LD_LIBRARYN32_PATH ".:$J3D/lib32/sgi"'

Bugs fixed in this release

On systems with Odyssey Graphics that supported 30 bit or higher visuals, such as Octane2 or Fuel, Java3D used to fail with an Exception:

Exception in thread "main" sun.java2d.InvalidPipeException: Unsupported bit depth: 30
   at sun.awt.X11SurfaceData.getSurfaceType(X11SurfaceData.java:420)
   ...

This has been corrected.

This is the official release of Java3D^TM 1.3.1.

Known Problems with Java3D^TM on IRIX

You will need to set the JAVA_OPENGL_NATIVE environment variable in order to have Java3D^TM work correctly.
```
setenv JAVA_OPENGL_NATIVE
```
Failure to set this environment variable will result in JVM crashes.

Reporting Problems/Support

Please contact your local Silicon Graphics support provider for all technical support issues including reporting bugs. In North America, you can contact the Technical Assistance Center at 1-800-800-4SGI. For other countries look here for the support center numbers.

For more general information on SGI's Java, see our site on Silicon Surf or contact us at java@corp.sgi.com.

Java and other Java-based names are trademarks of Sun Microsystems, Inc., and refer to Sun's family of Java-branded technologies. Sun, Sun Microsystems, and the Sun Logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Java3DTM Release Notes